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The IBM Customer Information Control System (CICS) is 

a transaction-oriented, multiapplication data base/data 
communication interface between a System/360 or System/370 
operating system and user-written application programs. 
Applicable to most online systems, CICS provides many 

of the facilities necessary for standard terminal appli- 

cations: message switching, inquiry, data collection, order 
entry, and conversational data entry. 


CICS is available in three systems — two for DOS users 

and one for OS users. Because the two CICS/DOS systems 

are compatible with each other and with the CICS/OS 

system, it is possible to start with a small data base/data 

communication configuration and move up through DOS 
into OS.. 


This manual provides information of interest to persons 
involved with terminal operation. These persons include: 
terminal operators, terminal supervisors, master terminal 
operators, application programmers, system programmers, 
and system administrators. 


Fifth Edition (November 1973) | 
This edition is a major revision obsoleting SH20-1044-3 and incorporating Technical Newsletter SN20-9014. 


This edition applies to Version 1, Modification Level 1, of the CICS/DOS-ENTRY (5736-XX6) and 
CICS/DOS-STANDARD (5736-XX7) program products and to Version 2, Modification Level 3, of the 
CICS/OS- STANDARD (5734-XX7) program products; it also applies to all subsequent versions and 
modifications unless otherwise indicated in new editions or Technical Newsletters. 


Changes are continually made to the information herein; before using the publication in connection with 
the operation of IBM system, consult the latest System/360 and System/370 SRL Newsletter (GN20-0360) 
for the editions that are applicable and current. 


Copies of this and other IBM publications can be obtained through your local JBM representative or at 
the IBM branch office serving your locality. 


A form for reader’s comments has been provided at the back of this publication. If the form has been 
removed, address comments to IBM Corporation, Department J04, 1501 California Avenue, Palo Alto, 
Cal fornia 94304. Comments become the property of IBM. | 


© Copyright International Business Machines Corporation 1971, 1972, 1973 


oh Sele ome ep 


This publication describes the use of terminals with three IBM 
program products: CICS/DOS-ENTRY, CICS/DOS-STANDARD, and 
CICS/OS-STANDARD V2. It provides single terminal operators, supervisory 
terminal operators, master terminal operators, application programmers, 
system programmers, system analysts, and system administrators with 
-informaticn concerning terminal operation considerations, terminal 
service functions, and messages sent to a terminal by CICS. 


This publication is not intended to describe the actual operation 
of a specific device. For that information see the appropriate terminal 
operator's manual. 


The words "transaction" and "task" have the same connotation in CICS 
and are used interchangeably throughout this publication; the processing 
of a transaction may involve the execution of one or more "programs". 


For further informaticn concerning CICS, see the following IBM 
publications: 


General Infcrmation Manual (GH20-1028) 

Application Programmer's Reference Manual (SH20~1047) 
System Programmer's Reference Manual (SH20-1043) 
Operations Guide (CICS/DOS) (SH20-1034) 

Operations Guide (CICS/0S) (SH2Z0-1048) 

Logic Manual (CICS/DOS-ENTRY) (LY20-0712) 

Logic Manual (CICS/DOS-STANDARD) (LY20-0713) 

Logic Manual (CICS/OS-STANDARD V2) (LY20-0714) 


All references to CICS/OS and CICS/OS-STANDARD in this publication 
are references to the CICS/OS-STANDARD V2 system. 
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INTRODUCTION 


OSE OF TERNINALS IN CICs 


Terminal operation in the CICS system environment is mainly 
characterized by the use of transactions. Transactions are initiated 
by entering an identification statement which specifies a valid 
transaction code. Any operator of a terminal may communicate with a 
transaction uSing several different methods. These are: single 
transaction entry, ccnversational entry, and data collection. 


A single function entry is one which invokes a transaction that 
requires no interaction with the terminal operator. The conversational 
entry transaction may require several interactions with the terminal 
operator. Data collection entry is one that may require little 
interaction with the terminal operator, but may require many entries 
by the operator for each response from the system. 


TERBINAL OPERATOR 


A terminal operator enters predefined transactions at a terminal to 
initiate certain desired functions. These functions may consist of 
inguiries to the contents of his data base, update or add to the 
information contained in his data base, or possibly perform calculations 
and return the results. Most of these transactions are user-defined. 

In these transaction cases, the user has the responsibility of educating 
each terminal operator concerning any special procedures defined by 

the user for the execution of the system. Included should be the 
procedures to be followed when the system abnormally terminates or when 
"end of day" occurs. 


CICS provides certain transactions which may be invoked by the 
terminal operatcr. The system service functions of these transactions 
are explained in a later section. 


The terminal operator must ke aware of those transaction codes he 
is allowed to enter and the required format for the transactions. He 
should also be aware of any messages that might be generated by the 
transactions he invokes, as well as any corrective action that must be 
taken in case of error conditions. In addition to these messages, the 
terminal operator should be aware of any other messages that CICS might 
transmit to his terminal. Sometimes it is necessary for a terminal 
operatcr to be aware of the terminal identifications of other terminals 
with which he may have tc communicate. 
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SUPERVISORY TERMINAL OPERATOR 


A supervisory terminal operator has the responsibility of keeping 
operational all terminals under his supervision. This is accomplished 
through the use of certain CICS provided transactions, which are defined 
later in this manual. 


Generally, all terminal operation considerations applicable to the 
single terminal operator are alsc applicable to the operator of a 
supervisory terminal. In addition, the supervisory terminal operator 
should be aware of those functions he can perform that are not available 
to the single terminals under his supervision. 


The supervisory terminal operator should know the identification of 
all terminals and operators under his supervision. He should also be 
aware of the status of each terminal and understand the procedure 
necessary to change the status of each terminal. 


MASTER TERMINAL OPERATOR 


All terminal operation considerations applicable to the other 
terminal operators are also applicable to the operator of the master 
terminal. In addition, the master terminal operator must be familiar 
with all procedures associated exclusively with the master terminal. 


The master terminal operator must have a general awareness of the 
terminals and operators that are capable of accessing CICS at any given 
time. As in the case of the supervisory terminal operator, he should 
know the current status of each terminal in the event he needs to change 
that status. 


Since the master terminal operator is normally the only one allowed 
to change various system operating parameters, he must know what effect 
such changes might have on system performance. Thus, the master | 
terminal operator must have a good understanding of CICS operation. 


The process of changing the terminal status is invoked by the entry 
cf the appropriate transaction identification, depending upon the 
terminal designation as single, supervisory, or master. 


The service status of a line or a control unit can be changed at 
the master terminal by entering any terminal identification on the line 
cr ccntrol unit. If a terminal designated as a master terminal should 
become inoperative, the master terminal operator may sign on another 
terminal to establish a new master terminal. 


The types of terminal processing status are: 


1. TRANSACTION, indicates a terminal which can initiate transactions 
and receive messages on request. 

2. TRANSCEIVE, indicates a terminal to which messages can be sent 
autcmatically. 

3. RECEIVE, indicates a receive-only terminal (no input). 

4. INPUT, indicates a terminal that can send messages to CICS but 
cannot receive messages from CICS. 


The types of terminal service status are: 


1. OUT OF SERVICE, indicates that no reading or writing for the 
terminal is possible. 
2. IN SERVICE, indicates that the terminal is operational. 


The types of line and control unit status are: 


1. OUT OF SERVICE, indicates no reading cr writing for any terminal 
on that line or cantrol unit. 
2. IN SERVICE, indicates an operational line or control unit. 


A terminal with an OUT OF SERVICE or IN SERVICE status retains the 
appropriate processing status of TRANSCEIVE, RECEIVE, or TRANSACTION 
at the same time. Thus, a terminal which has both a TRANSACTION and 
IN SERVICE status may be placed OUT OF SERVICE without losing the 
TRANSACTION designation. When the terminal is again placed IN SERVICE, 
the former processing status of TRANSACTION is retained. The status 
of the terminals is originally established with the creation of the 
Terminal Control Table. 


Note: A display station should not have messages arbitrarily sent to 
it. It is possible to overlay an existing message at the display 
Station before the existing message has served its full purpose. 
Therefore, the user must use TRANSCFIVE and RECEIVE with caution 
On video devices. 


The operator at a single terminal can alter the status of his own 
terminal. An operator at a master terminal can alter the status of 
any or all terminals. In neither case is a Terminal List Table 
required. 


TERMINAL OPERATOR 


The operator of a terminal, cther than a supervisory cr master 
terminal, must have certain iniormation to perform his prescribed 
duties. For example, the operator must know the exact information to 
ke entered from his terminal to sign on the system. This information 
includes the necessary password and identification as specified in the 
Sign-on Table. The transaction identification CSOT must be entered 
‘immediately following the sign on transaction to identify a single 
terminal. | 


Once signed on, the terminal operator must be aware of those 
transaction codes he is allowed to enter and he should also be aware 
of any error messages that might be generated by the transactions he 
invokes, as well as any corrective action that must be taken. In 
addition to the error messages, the terminal operator should be aware 
cf any other messages that CICS might transmit to his terminal. 
Sometimes it is necessary for a terminal cperator to be aware of the 
terminal identifications of other terminals with which he may have to 
communicate. He should certainly know the terminal identification of 
his supervisory and/or master terminal. 


The user has the responsibility to educate each terminal operator 
concerning any special procedures defined by the user for the execution 
of the system. Included should be the procedures to be followed when 
the CICS system terminates. 


INITIATING TRANSACTIONS 


A CICS transaction is normally initiated from a terminal by the 
operator entering a valid identification statement which specifies a 
transaction code. For CICS provided transactions such as CSMT, the 
operator of a 3270 must clear the screen before entering the transaction 
code. This may be true of user transactions, depending ufon their 
design. CICS transaction codes are always four characters in length 
and must start in the first position of an entry. Depending upon the 
transaction, additional data may be presented along with the transaction 
code, as follows: 
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| 
| AAAA JOHN DOE, 12489 | 


In this example, a CICS transaction identified as AAAA is initiated 
to process the data submitted with the transaction codes. At the 
completion of transaction AAAA, the user might choose to transmit a 
completion message back to the terminal, such as: 


PROCESSING COMPLETE 


Another type of transaction may require that the terminal operator 
answer a series of specific questicns. For example: | 
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Operator keys: STAT 

CICS responds: **WHAT IS STUDENT ID? 

Operator keys: 12345 

CICS responds: **WHAT INFORMATION IS REQUIRED? 
Operator keys: GPA 

CICS responds: **GRADE POINT AVG=3.67 

CICS: **END OF TRANSACTION 
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Some transacticns may require little or no interaction between CICS 
and the terminal operator. The following example is typical of this 
type of transaction: 
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Operator keys: UPDT 

CICS responds: **BEGIN DATA INPUT, KEY "END* WHEN 
FINISHED 

Operator keys: 123 A 

Operator keys: 456 B 

Operator keys: 789 C 

Operator keys: 363 A 

Operator keys: END 

CICS responds: **TRANSACTION COMPLETE 
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2741 TERMINAL PROCEDURE 


To initiate communication with CICS using 2741 Terminals proceed as 
follows: 


Dial Lines - With the terminal power switch off and the mode switch 
set to ccmmunicate, dial CICS. After connection is established, turn 
the power on and enter the terminal identificaticn. Thereafter, the 
mcde and power switches must remain as set, otherwise invalid data may 
be transmitted or an unwanted disccnnect can occur. To terminate 


communication, type either "DISC" or "CSSF GOODNIGHT." 


Leased Lines - Turn power on and set mode switch tc communicate. 
Thereafter, switches must remain as set otherwise invalid data may be 
transmitted. Any transaction in progress must be ended before switching 
to local mode for offline use. When the terminal is brought back online 
(in communicate mode), the initial transaction entry may produce an 
invalid transaction identification. If this occurs, rekey the 
transaction identification. 


2980 GENERAL BANKING TERMINAL EROCEDURE 


Models 1 and 4 of the 2980 General Banking Terminal do not have an 
equal sign (=). To use these terminals as Master Terminals, the 
operator must substitute the asterisk (*) wherever the equal sign would 
normally be used. 


2260 COMPATIBILITY FOR THE 3270 


2260 compatibility support for the 3270 Information Display System 
allows the user to run his Currently operational 2260 based transactions 
from a 3270. If compatibility is being used, the operator must be made 
aware of which transactions are 2260 based transactions. When working 
with these type transactions the operator must be aware of the 
considerations that follow. 


Start Of Message Indicator (SMI) 


When communicating with a 2260-based transaction, the SMI character 
is used to indicate the beginning cf the input message. On the 2260, 
the start symbol ( p) is displayed as the SMI character. On the 3270 
the start symbol will normally be represented by the Panes 
characters: 


USA g 
U.K. $ 
French ¢ orc 
German oO 


However, the user installation may have defined a different character 
for use as the start symbol when assembling the Terminal Control 
Program. If this is the case the terminal operator must be made aware 
of what character is being used. 


If an SMI character is not placed on the screen by the user's 2260 
data stream, the operator must then key an SMI character somewhere on 
the screen before entering data. Failure to do so results in the "START 
SYMBCL MISSING" message being transmitted to the terminal. 


New Line Symbol (NL) 


For CICS 2260 compatibility, the new line (NL) function is simulated 
by first pressing the field mark key fcllowed by the NL key. A field 
mark key should not be used for any cther purpose. | 


On a message received at the terminal, the field mark character . 
representing a new line symbol will be displayed as a semicolon. 


60 Tab Feature 


The tab feature of the 2260 is simulated on the 3270. However, if 
the 2260 tab feature is being used the operator should be aware that 
the tab stop character (colon) dces not appear on the 3270 screen. 
When the tab key is pressed the cursor will be positioned in the Same 
manner as on the 2260. Also, a tab stop character cannot be entered 
from the keyboard. 7 


Entering Transactions 


The terminal operator can initiate either 2260 compatibility or 
3270-hased transactions by entering the appropriate four-character CICS 
transaction code. Any Start of Message Indicator (SMI) character in 
the input data stream is recognized by CIcS; the succeeding four 
characters are interpreted as a CICS transaction code. CicS then 
initiates the specified transaction. If the specified transaction is 
a 2260 ccmpatibility transaction, CICS automatically formats the 3270 
screen. The transaction code must be contained on one line. 


To allow easy transition between 2260 compatibility and 3270-based 
transactions, some ccnventions should be followed. Two acceptable 
methcds of transition between transactions are: 


1. Clear the screen, then enter the transaction code and any data 
to be presented to the transaction. In this case, the operator 
must enter the transaction code at the first position of the 
screen. The transaction code has to be preceded by the SMI 
character, in which case the next four characters are interpreted 
as the transaction code. 


2. For a terminal in compatibility mode, enter the SMI character, 
the transaction code, and data. If the transaction to be 
initiated is a compatibilty transaction, all data from the SMI 
Character to the cursor position is treated as a 2260 
compatibility data stream and is mapped into 2260 format. 


Note: When operating in compatibility mode, care must be taken to 
avoid placing the cursor in a protected area. If this happens 
and the operator attempts to enter data, the keyboard will become 
inoperable. Avoid this situation by using either tab, backspace 
tab or new line key. If the keyboard becomes inoperable, depress 
the reset key. 


TERMINALS ON SWITCHED LINES (DIAL-UP) 


The operator of a terminal connected to the system via a switched 
(dial-up) line must be aware of some situations in which CICS is 
dependent upon the operator. If the line connection is estabiished by 
the terminal operator (that is, operator dials to establish line 
connection), the terminal must be identified to CICS by the operator. 
To accomplish this, the operator must enter the four character terminal 
identification assigned to that terminal immediately after line 
connection has been established. If the identification is valid, the 
system responds with a ready message. Normal operation may proceed at 
this time. If identification is invalid, an error message is returned 
and the terminal is disccnnected. The READY message does not occur on 
Frogrammable bisynchronous devices. 


Note: The ANSWRBK operand of the DFHTCT TYPE=LINE macro instruction 
specifies ccnditions under which the terminal operator does not 
enter the terminal identification. These conditions are 
Summarized below: 


ANSWRBK Terminal Condition 
AUTOMATIC Teletype (Model 33/35) Use of the Answerkack drum 
for terminal identification. 


NULL 71770 A CICS system option provides 
automatic connection without 
terminal identification. 

If for some reason CICS 
cannot accomplish the 
ccnnection, an error message 
will be returned after the 
first data entry and the 
terminal will be 
disconnected. 


EXIDVER 3735 Mandatory-terminal 
identification performed 
automatically by terminal. 


To disconnect the terminal from the line the terminal operator should 
enter the four character keyword DISC. This keyword is valid only if 
there is no transaction currently in progress for that terminal. 


The DISC keyword has no meaning to the operator of a 3735 
Programmable Buffered terminal. The disconnect function is normally 
performed automatically by CICS or the 3735 hardware. 


Note: Ncne of the system service prcegram operating procedures discussed 
in the following sections are applicable to the 3735 Programmable 
Buffer Terminal operator. These programs cannot be run by the 
3735 operator unless special Form Description Programs (FDP's) 
have been written for the 3735 to handle the communication with 
these transactions. If this is the case, the directions for 
running these FDP's should be obtained from the 3735 programmer. 


TERMINAL SIGN ON/SIGN OFF 


The optional sign on/sign off function is used when a terminal 
Operator signs on or off the system. When the sign on/sign off 
procedure (described below) is prererly executed by the operator, the 
fcllowing system functicns are accomplished: 


e Establishes an operator priority value for all transactions 
initiated freom his terminal. 


e Places the terminal in Receive mcde once sign off is accomplished. 


e Provides the operator with the security keys to access the functions 
needed. : 


Sign-On Procedure 


A terminal is designated a supervisory terminal or master terminal 
through the use of a security key. The sign-on procedure establishes 
a security key which allows the operator to invoke the appropriate 
programs. All transactions subsequent to the sign-on frocedure are 
subject to a security check. 


A sign on transaction is initiated by entering at the terminal 
(starting at line position 1) the following: 


CSSN PS=password, NAME=name of operator 
Upon nermal ccmpletion of sign on, the following message is returned: 
SIGN ON IS COMPLETE 


This sign on associates the operator with the particular terminal 
thereby establishing a security key for all transactions entered from 
his terminal. The password and operator name that are entered must 
exactly match the entries in the Sign-on Table. If the password has 
fewer than four characters, blanks must be entered after the password 
for a total of four characters. The Sign-on transaction may also be 
initiated by a numeric-only terminal such as a Touch-Tone* telephone 
using a 7770 Audio Response Unit Model 3 by entering (starting at line 
position one) the following: 


«Trademark of the American Telephone & Telegraph Co. 


9999pppp0C0000... where: peppp is a four-digit password and 
0C0000... is a one- to twenty-digit number used to identify the 
terminal operator, such as operator serial number. 


Note: If sign on is required for 2760 operation, the user-defined sign 
cn procedure must be accomplished on the associated 2740 
keyboard. Also, if sign cn is required on a 1030, it can only 
be entered through operator badge input on the CARD Reader. If 
the terminal communicates with a 7770, the ready message is 
returned by CICS. 
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The sign-off transaction that signs off the operator but not the 
terminal is initiated by entering (starting at line position one) at 
the terminal: 


CSSF 


This can also be accomplished from a numeric only terminal by 
entering at line position one: 


8888 


Upon ccmpletion of this sign-off transaction, the following message 
is returned: 


SIGN OFF IS CCMPLETE 
The other type cf sign-off transaction that could be used is: 
CSSF GOCDNIGHT 


This can also be accomplished from a numeric only terminal by 
entering: 


&E888888 


Again, upcn completion of either sign off, the following message is 
returned: 


SIGN OFF IS CCMPLETE 


This sign off transaction (CSSF GOODNIGHT) accomplishes the following 
Within the CICS System: 


1. Disestablishes association with operator priority and security 
key. 

2. Sign off terminal as well as operator, allowing CICS to ignore 
that particular terminal for input. If the terminal is in 
TRANSCEIVE or put into RECEIVE status, any auto-initiated output 
messages continue to be sent. 

3. Enhances security. 

4, Provides a statistics record written to CSSL. 


The following message is sent to destination CSML by the Sign-off 
program: 


DFHSFOOT xxx yyyyy zzz 


wheres xXX = operator identification from Sign-on Table 
YYYYY = number of transactions processed 
ZZzZ = number of transaction errors 


ATP BATCH PROCESSING 


One or more transactions and any associated data may be submitted 
from a terminal in batch mode by requesting the services of the 
Asynchronous Transaction Input Processor through a CRDR transaction 
ID. Unlike transactions submitted in conversational mode, transactions 
within a batch are not processed until Input Processor detects a 
delimiter statement. 


When a batch delimiter statement is encountered, the terminal is 
freed for other use and the transactions within a batch are processed 
sequentially. Any output for the terminal will not be sent until the 
terminal operator requests it. 


Example: 


CRDR NAME=BATCH1,DELIM=$S$$$ 
TRNA 
data 
data 
$$$$ 
TRNB 
data 
TRNC 
TRNA 
data 
$2$$ : 
$$$$ : 
CRDR NAME=BATCH2, EXIT=A3 
TRND data,data 
TRND data,data 
TRND data 
TRNA 
data 
data 
/* 


Note: If a transaction in this batch were to abnormally terminate, 
subsequent data would be skipped. A single occurrence of an 
explicitly defined delimiter will stop the skipping and permit 
normal processing to resume. 


Output from batches can be requested by submitting a request for 
the services of the Asynchronous Transaction Output Processor through 
use of a CWTR command statement. 


For example, 
CWTR NAME=(BATCH1,BATCH2) | 
The Output Processor will transmit the output (if any) of the specified 
katches to the selected destination. It is possible to automatically 
receive output upon completion of a batch DY submitting a CWTR statement 
along with the input. 


For examples 


CRDR 
TRNA data 


10 


; 

{ l | 

| Transaction| Operands 

| ID ( 

; { 

acacia oe arora a a a a | 
CRDR NAME=batch name, 


EXIT=program identifier, 


( | 
l | 
{ DELIM=delimiter indicator, | 
| 
{ PASSWD=password { 
( ( 


Note: Terminals must be able to transmit the character "=" jin order 
to use CRDR services. 


CRDR: Transaction identification which causes CICS to accept batched 
transactions. 


NAME: Specifies the one- to eight-character symbolic name to be 
associated with this particular batch. This name is used to identify 
the batch for the CWTR statement. If omitted, the batch is 
automatically named by CICS and the name is passed back to the terminal 
operator within the DFH1950 terminal message. (Refer to "Requesting 
CWTR Services",) 


DELIM: Specifies the one- to four-character symbolic delimiter for 

the batch. CICS continues reading from the terminal until it encounters 
two successive occurrences of this statement. If no delimiter is 
specified, the default is */**, and a single occurrence of this default 
delimiter will terminate reading the batch. 


EXIT: Specifies the one=- or two-character identifier of a user-provided 
exit program which is to be used to edit the input data before it is 
queued (stored). 


PASSWD: Specifies the one to eight character password that prevents 
unauthorized access cr knowledge of the associated batch. If a password 
is specified on the CRDR statement, the same password must be used on 
the CHTR statement when requesting batch services. 


All parameters must be submitted in the Same message with the 
CRDR characters. 
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Two additional services are provided with the final (or only) 
delimiter statement: HOLD and DELETE 


Processing the input of the batch is usually initiated as soon as 
the input of the batch is complete. If this processing is to be 
delayed, the input can be completed but held, by following the batch 
delimiter with a space and the word HOLD. For example: 


17 


CRDR 
TRNA data 


/* HOLD 


If during submission of a batch, the operator realizes the batch 
should net be processed the delimiter(s) can be entered. The last (or 
Only) delimiter should be followed by a space and the word DELETE. 


If no delimiter has been specified, in the CRDR message, the HOLD 
or DELETE command starts one space after the default delimiter, /*. 
If a delimiter has been specified, the HOLD or DELETE command starts 
one space after the second user-specified delimiter. For example: 


CRDR DELIM=ABCD 
TRNA data 


ABCD 
ABCD DELETE 


Requesting CWIR Services 


{| Transaction 
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f NAME= (batchname,batchnane,) 

|  TERMID=(terminal ID,terminal ID,) 
| SOURCE=terminal ID, 

{ COPIES=n, 

{ EXIT=program identifier, 

{ PASSWD=password, 

j SAVE, DELETE, RELEASE, STATUS, 

{ 
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Note: Terminals must be able to transmit the character "=" in order 
to use CWTR services. 


CWIR: Transaction identification which causes the batch output from 
CICS to be sent to the terminal. 


NAME: Specifies one or more names of batches to be transmitted to the 
specified destination. If omitted, all batches submitted by this 
terminal, (which are ready) are processed. If only one batch name is 
entered, parentheses are not required. 


TERMID: Specifies the terminal identificaticn to which output of 
specified batches is to be sent. If omitted, the output of all batches 
will be sent to this terminal. If only one terminal ID is entered, 
parentheses are not required. | 


SOURCE: If a Latch that originated at another terminal is requested, 
that terminal's ID must be specified in this field. If SOURCE=ALL is 
specified, all batches represented in the system are eligible for 
action. For example: CWIR STATUS,SOURCE=ALL, PASSWD=ALPHA obtains the 
status of all batches not password protected as well as those that are 
protected by the password ALPHA. 
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COPIES: Specifies the number of copies, less than 256, of the specitied 
output to be generated. If omitted, one is assumed. 


EXIT: Specifies the one- or two-character identifier of an optional 
user-provided exit routine which is to be used to edit output data 
before transmission to the terminal. 


PASSWD: If any of the batches requested are password protected, the 
password must be entered in this field. 


SAVE: The batch (es) named are not be deleted until an explicit request 
tc do so is made. 


DELETE: The batch(es) named are deleted from the system. 
RELEASE: The katch(es) named are released from HOLD status. 


STATUS: The status of all batches for this terminal (or those named) 
are transmitted to the terminal. 


Note: All parameters must be submitted in the same message with the 
CWTR characters. 
MODIFY TERMINAL STATUS 
The terminal cperator can inquire about the status of his own 


terminal or change the processing status of his own terminal. He cannot 
place his terminal IN SERVICE or OUT OF SERVICE. Examples are: 


1. ENTER: CSOT TERMNL,SINGLE, INQURY 
RECEIVE: STATUS IS 
IN SERVICE 
TRANSACTION 
2- ENTER: CSOT TERMNL,SINGLE,TRNCV 
RECEIVE: STATUS IS 
IN SERVICE 
TRANSCEIVE 


Any request by a master terminal, a supervisory terminal, or an 
operator terminal can be canceled by entering (anywhere in any of the 
data entries): 


ENTER: CANCEL 
RECEIVE: CANCEL REQUESTED BY TERMINAL OPERATOR 


Note: This command is not effective for the system terminai test, 
discussed elsewhere in this section. 


TERMINAL TEST FUNCTION (CSFE) 


The Terminal Test Function is designed to help the IBM Field Engineer 
to diagnose hardware problems. It is applicable to all terminals 
supported by CICS except for the 2780, 3735, output only printers (e.g. 
3270 Printers), and terminals communicating with a 7770 Audio Response 
Unit. This function is initiated by entering the transaction 
identification CSFE. The inputs to CSFE are as follows: 
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input Response 


PRINT All characters printable at that terminal, 
are transmitted. 

END Terminates CSFE. 

Anything else The input message is returned to terminal. 


The fcllowing is an example of the terminal test transaction. The 


underlined portions have been entered from the terminal. 
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csfe 

ENTER PRINT FOR CHARACTER SET 
ENTER END TO TERMINATE 

ALL OTHER DATA WILL BE ECHOED 


ail is well 


ALL IS WELLprint 
abcdefghijkimnopgqrstuvwxyz 
ABCDEFPGHIJKLHNOPQRSTUUWKXYZ 
0123456789 
= 32%" *()_ +6 @1S" , .?/ 

. Eepeat 
REPEATeng 
TRANSACTICN COMPLETE 


SUPERVISORY TERMINAL OPERATOR 


MODIFY STATUS OF SUPERVISED TERMINALS 


A supervisory terminal can change the status of a single terminal, 
a list of terminals, a class of terminals, or all the terminals it 
supervises. The transaction identification CSST must be entered to 
identify a terminal as a supervisory terminal. 


A CLASS of terminals consists of those terminals defined in one 
Terminal List Table. It is specified by CLASID=xx where xx is the 
suffix which makes DFHTLTxx a unique name. A LIST of terminals consists 
of those terminals listed by the operator via the operand 
TERMID=t1,t2.... 7 


A Terminal List Table is required for (1) a supervisor to alter the 
status of any terminal under the supervisor's control and (2) a 
supervisor operator to alter the status of a group (class) of terminals. 
The interaction between the computer and the operator requires either 
the supervisor's two-character key or the class of terminals. The 
response to the computer must be the same two characters as the 
two-character suffix that was appended to the name of the appropriate 
Terminal List Table. 


When a Supervisory terminal puts a single terminal OUT OF SERVICE, 
the supervisory terminal has four cptions for servicing any task that 
may be attached to that terminal: SUSPEND, INTERCEPT, TERMINATE, or 
DISPLAY the task. If the superviscry terminal elects to suspend th 
task, the transaction remains attached to the operator terminal and 
may be completed when that terminal is returned to an IN SERVICE status. 
If the supervisory terminal intercepts the task, the transaction is 
attached to the supervisory terminal for completion and the operator 
terminal is placed OUT OF SERVICE. If the supervisory terminal 
terminates the task, the transaction is abnormally terminated and the 
terminal is placed OUT OF SERVICE. When the supervisory terminal 
displays the task, the task is suspended pending further action and 
the transaction identification is displayed on the supervisory terminal. 
At this point, the supervisory terminal may select one of the remaining 
opticns to complete the servicing of the task. 


Note: The INTERCEPT feature is net provided in the CICS/DOS-ENTRY 
systen. 


In the CICS/DOS-ENTRY system, the transaction identification of the 
transacticn associated with the operator terminal may not be available. 
If this is the case, a message to that effect is displayed. fhe 
supervisory terminal may then elect to TERMINATE, SUSPEND, or DISPLAY 
the transaction again. 


When a supervisory terminal puts a line, a control unit, all 
terminals, a list of terminals, or a class of terminals OUT OF SERVICE 
while a task is attached, it has two options for servicing the 
transaction: (1) SUSPEND the transaction or (2) TERMINATE the 
transaction. 


The identification code for a terminal is the same terminal 
identification that is contained in the Terminal Control Table. 
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Note: 
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Example transactions are: 


ENTER: 
RECEIVE: 
ENTER: 
RECEIVE: 


ENTER: 
RECEIVE: 
ENTER: 
RECEIVE: 


CSST TERMNL,LIST, INSRV,SUPRID=01 
ENTER LIST OF TERMINAL IDS 
TERMID=FVAR,ODAN, 1592 

TERMINAL IDS 

STATUS IS CHANGED 


CSST LINE, OUTSRV, TRMNAT, TERMID=2222 
ENTER SUPERVISOR ID 

SUPRID=21 

LINE 

OUT OF SERVICE 

6 TASKS WERE ACTIVE 

6 TASKS WERE TERMINATED 


A supervisory terminal operator cannot put a line OUT OF SERVICE 


unless all terminals on the line are in the appropriate Terminal 
List Table. In this example, the terminals must be present in 


TLT21. 


To put the line IN SERVICE, only the single TERMID specified 
must be present in the TLT. A control unit request operates in 
the same manner. 


BASTER 


MODIFY 


The 


TERHINAL OPERATOR 


OPERATION OF CICS 


master terminal operator can change the processing status of a 


Single terminal or, a list of terminals, or may change the service 
status of a single terminal, a list of terminals, class of terminals, 
a line or a Remote 2848 Display Control Unit. The transaction 
identification CSHT must be entered to identify a terminal as a master 
terminal. 


Services provided by 
terminal cperator to: 


the Master Terminal program allow the master 


1. Inquire about or change the partition exit time interval value. 
2. Inquire akout or change the runaway task interval value. 

3. Inquire about or change the stall detection interval value. 

4. Inquire about or change the storage cushion size. 

5S. Inquire akout or change the maximur number of tasks value. 

6. Inquire akout or change the maximum number of batch tasks value. 
7. %Inquire about or change the maximum number of ATP tasks value. 
8. Inguire about or change the negative poll delay for a terminal. 
9. Inquire about or change the trigger level of a transient data 


intrapartition data set. 


10. Turn the CICS Trace function on or off. 
11. Inquire about or change the processing or service of a single 
terminal. 
12. Change the processing or service status of a list of terminals. 
13. Change the service status of a class of terminals. 
14. Change the service status of all the terminals in the system. 
15. Inquire about or change the status of a line. 
16. Inquire ahout or change the status of a control unit. 
17. Inquire about or change the status of one or more data base 
data sets. 
18. Open one ocr more data base data sets. 
19. Open one or more transient data extrapartition data sets. 
20. Open the dump data set. 
21. Close one or more data base data sets. 
22. Clcse one or more transient data extrapartition data sets. 
23. Close the dump data set. 
24. Switch the dump data to the alternate dump data set. 
25. Inquire about the status of a program. 
26. Terminate a task. 
27. Terminate CICS. 
Note: Some of the above Master Terminal Services require the use of 


the character "=", Terminals must be able to transmit this 
character in order to use these services. 


Master Terminal operations against a terminal identification ina 
TCAM terminal pocl (if POOL=YES was specified in the DFHTCT 
TYPE=TERMINAL macro instruction) are not meaningful because CICS makes 
this assignment dynamically. 


The requesting terminal may indicate in the original data entry the 
service to be performed and all the information required to perform 
that service. This is done by keying a space after the transaction 
identification fcllowed by (1) a series of abbreviated keywords in any 
order, (2) a numeric value, and/or (3) a parameter list that describes 
either partially cr fully the service to be performed. Each abbreviated 
keyword, numeric value, and parameter must be separated by a comma. 
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A parameter equal keyword must immediately precede the first 
parameter of a parameter list. The parameter list must be entered 
last. The system ignores all invalid keywords and parameters in the 
Criginal data entry. It also ignores every numeric value and parameter 
list except the last ones entered. This facilitates correction of 
information in the original data entry. The incorrect information need 
simply be fcllowed by a comma and the correct information entered 
(whether it be an abbreviated keyword, a numeric value, a parameter, 

Or an entire parameter list). : 


Note: Care must be exercised when correcting parameters for a terminal 
list status change. Every valid symbolic terminal identification 
in the parameter list causes that terminal's status to be 
changed. 


If, after analyzing the original or subseguent data entries, the 
Master Terminal frogram cannot determine what service has been 
requested, or if enough information has not been entered to perform 
the requested service, more infcrmation is solicited from the requesting 
terminal. The response to a request for more information must be an 
unakbreviated keyword, a numeric value, or a parameter list. 


Below are three examples cf how a master terminal operator might 
inquire about the status of the single terminal identified as L60A. 
The informaticn entered by the master terminal operator has been 
underlined. | 


STATUS IS 
IN SERVICE 
TRANSCEIVE 


CSNT_JNOQURY ,.TETNNI TERMNE 

SINGLE, LIST, CLASS, OR ALL SINGLE 
ENTER TERMINAL ID TERMID=L60A 
STATUS IS 

IN SERVICE 

TRANSCEIVE 


Note: The misspelled keyword TETMNL was ignored by the Master Terminal 
program. 


Csut | 

WHAT SERVICE IS REQUESTED? 

TERMINAL 

SINGLE, LIST, CLASS, OR ALL INQUIRY 
SINGLE, LIST, CLASS, OR ALL SINGLE 
ENTER TERMINAL IL TERMID=L60A 
STATUS IS 

IN SERVICE 

TRANSCEIVE 


Note: The keyword INQURY could have been entered at any time in this 
last example, 


The operator should be aware of the fcllowing restrictions in the 
use of the Master Terminal Progran. 


1. Only the last numeric value in the original data entry will be 
accepted from that data entry. 


2. Only the last parameter list in the original data entry will be 
accepted from that data entry. 
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Only abbreviated keywords, a numeric value, and a parameter lis: 
may be entered in the original data entry. 


Only unabbreviated keywords, a numeric value, or a parameter lis 
may ke entered in a response to a request for more information from 
the Master Terminal Prcgran. 


Only cne of the fcllowing keywords may be entered for each use of 
the Master Terminal Progran. 


ATP MAXIMUM TASKS (ATEMXT) 
BATCH MAXIMUM TASKS (BMAXT) 
CLOSE 

CCNSECUTIVE DISPATCH LIMIT (CDL) 
CONTROL UNIT (CNTRL) 
CUSHION (CUSH) 

LINE 

MAXIMUM TASKS (MAXT) 
NEGATIVE ECLL (NEGP) 

OPEN 

PROGRAM (EGRM) 

RUNAWAY (RNAWAY) 

SHUTDOWN (SHUTDN) 

STALL 

SWITCH 

TERMINAL (TERMNL) 

TIME 

TRACE 

TRIGGER (TRIGER) 


Only one of the fcllowing keywords may be entered for each use 0: 
the Master Terminal Program 


SINGLE 
LIST 
CLASS 
ALL 


Only one of the following keywords may be entered for each use of 
the Master Terminal Progran. 


TERMINATE 
SUSPEND 
INTERCEPT 
DISPLAY 


Note: If DISPLAY is entered when putting a terminal out of service, 


the Master Terminal Program will display the transaction . 
identification of the task associated with the requested terminal 
and will then ask for one of the other three keywords above. 


Only one of the following keywords may be entered for each use of 
the Master Terginal Precgran. 


ON 
OFF 


Qnly one of the following keywords may be entered for each use of 
the Master Terminal Precgranm. 


IN SERVICE 

OUT OF SERVICE 
RECEIVE 
TRANSCEIVE 
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TRANSACTION 


10. Only one of the following keywords may be entered for each use of 
the Muster Tertinal Precgran. 


DATA BASE (DATBAS) 
DUMP | 
TRANSIENT DATA (TRANSD) 


11. There are certain cases in which the Master Terminal Program may 
not ke able tc terminate a task when requested to do so. If the 
request is te terminate a task without putting the terminal 
associated with the task out of service, the Master Terminal Program 
will respond with the message "TASK WAS ACTIVE", If the request 
was to put a terminal out of service and to terminate the task 
associated with that terminal, the task will be suspended anda 
message to that effect will he returned. If the requested service 
was to put a line or control unit out of service and terminate any 
tasks associated with the terminals connected to that line or 
control unit, a message is issued indicating how many tasks were 
suspended will be returned. 


The master terminal can also inquire about or change any of the 
following parameters relating to the operation of CICS. Each parameter 
is defined, and examples showing typical operator entry and terminal 
response are given as applicable. 


a. System partition/region exit time interval 


Definition: Inquire about or change the maximum time interval in 
tmilliseconds that CICS will release control to OS in the event 
there are no transactions ready to resume processing. Typical time 
interval might be 1000 milliseconds. Examples are: 


1. ENTER: CSMT 
RECEIVE: WHAT SERVICE IS REQUESTED 
ENTER: TIME | 
RECEIVE: WHAT IS THE NEW TIME INTERVAL VALUE 
ENTER: 2000 


RECEIVE: THE TIME INTERVAL IS CHANGED TC 2000 FROM 1000 


2. ENTER: CSMT TIME,2000 
RECEIVE: THE TIME INTERVAL VALUE IS CHANGED TO 2000 FROM 1000 


3. ENTER: CSMT TIME, INQURY 
RECEIVE: TIME INTERVAL VALUE IS 1000 


b. Runaway task time interval 
Definition: Inquire about or change the time that a task can be 
in a runaway (loop) condition. Typical runaway time interval might 
be 5000 milliseconds. Examples are: 


1. ENTER: CSMT KNAWAY 


RECEIVE: WHAT IS NEW RUNAWAY TASK INTERVAL VALUE 
ENTER: 4000 


RECEIVE: RUNAWAY TASK INTERVAL IS CHANGED TO 4000 FROM 5000 


2. ENTER: CSMT RNAWAY,0 
RECEIVE: RUNAWAY TASK INTERVAL IS CHANGED TO 0 FROM 4000 


Note: Setting runaway to zero causes runaway to be inoperative. 
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3. ENTER: CSMT RNAWAY,INQURY 
RECEIVE: RUNAWAY TASK INTERVAL IS 0 


Storage cushion size 


Definition: Inquire about or change the storage cushion to minimi:.: 
overload conditions. However, cushion size does not actually chang: 
until existing cushion is released. When cushion is regained, the 
cushion will be the size indicated by the new value. Examples are: 


Ve. “ENTER? CSMT 

RECEIVE: WHAT SERVICE IS REQUESTED? 

ENTER: CUSHION 

RECEIVE: WHAT IS THE NEW CUSHION SIZE 

ENTER: 1900 

RECEIVE: CUSHION SIZE IS CHANGED TO 1900 FROM 2000 
2. ENTER: CSMT CUSH,500 

RECEIVE: CUSHION SIZE IS CHANGED TO 500 FROM 500 
3. ENTER: CSMT CUSH,INQURY 

RECEIVES CUSHION SIZE IS 500 


Maximum number of tasks designation (not applicable to 
CICS/DOS~-ENTRY). 


Definition: Inquiry about or change the limit of the number of 


tasks that can be active in the CICS system at any one time. The 
range is from 1 to 999. Examples are: 


1. ENTER: CSMT 
RECEIVE: WHAT SERVICE IS REQUESTED? 
ENTER: MAXIMUM TASKS 
RECEIVE: WHAT IS THE NEW MAXIMUM TASKS VALUE 
ENTER: 6 


RECEIVE: MAXIMUM TASKS IS CHANGED TO 6 FROM 5 


Zs. ENTERS CSMT MAXT,20 
RECEIVE: MAXIMUM TASKS IS CHANGED TO 20 FROM 25 


3. ENTER: CSMT INQURY,MAXT 
RECEIVE: MAXIMUM TASKS IS 20 


Maximum number of ATP tasks designation (not applicable 
to CICS/DOS-ENTRY) 


Definition: Inquire about or change the maximum number of ATP 
batches that can be in process at any one time. This does not 
include those being operated upon by CRDR or CWTR. For example: 


ENTER: CSMT INQURY,ATPMXT 
RECEIVE: ATP MAXIMUM TASKS IS 10. 


Maximum number of batched tasks designation (not applicable to 
CICS/DOS-ENTRY) 


Definition: Inguire about or change the maximum number of tasks 
which is a combination of regular terminal tasks and ATP batch 
tasks. For example: 


j 
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mam 
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RI 


ENTER:  CSMT INQURY, BMAXT 
RECEIVE: BATCH MAXIMUM TASKS IS 15 


Status of batched tasks (nct applicable to CICS/ DOS-ENTRY) 


Definition: Inquire into the status of batches currently 
in the system without regard to possible 
password protection. For example: 


ENTER: CSMT CWTR STATUS 
RECEIVE: DFH1960 T4OA XXXXXXXX STATUS BEING SAVED 
DFH1960 T51C XXXXXXXX STATUS BEING PROCESSED 


Refer to the explanation of message DFH1960 for further information. 
The word "BATCH" in the normal message will ke replaced, in this 
instance, by the terminal identification and, if the batch is 
password protected, an asterisk. 


Consecutive dispatch limit (CICS/DOS-ENTRY only) 


Definition: Valid only in the CICS/DOS-ENTRY, sets a limit to the 
number of input/cutput operations performed by a transaction before 
that task is rolled out. Can be any value between 1 and 999. 
Examples are: 


1. ENTER: CSMT 
RECEIVE; WHAT SERVICE IS REQUESTED 
ENTER: CONSECUTIVE DISPATCH LIMIT 
RECEIVE: WHAT IS THE NEW CDL VALUE 
ENTER: 10 
RECEIVE: CDL IS CHANGED FROM 5 to 10 
2. ENTER: CSMT CDL 
RECEIVE: WHAT IS THE NEW CDL VALUE 
ENTER: | 2 
RECEIVE: CDL IS CHANGED FROM 5 to 2 
3. ENTER: - CSMT INQURY,CDL 
RECEIVE: CDL IS 2 


Negative poll delay for a line 


Definition: Inquire about or change the negative poll delay for 
the line associated with a specific terminal. The default values 
vary by device type and range from 0 to 1600. Examples are: 


1. ENTER: CSMT 
RECEIVE: WHAT SERVICE IS REQUESTED? 
ENTER: NEGATIVE POLL 
RECEIVE: NAME A TERMINAL ON THE LINE 
ENTER: TERMID=XXXX 


RECEIVE: TERMINAL ID CANNOT BE FOUND 
NAME A TERMINAL ON THE LINE 


ENTERS: TERMID=nnnn (nnnn is a valid terminal id such as 
R60A) 

RECEIVE: WHAT IS THE NEW NEGATIVE FOLL DELAY 

ENTER: 1000 


RECEIVE: NEGATIVE POLL DELAY IS CHANGED TO 1000 FROM 960 


2. ENTER: CSMT NEGP=1000, TERMID=nnnn- 
RECEIVE: NEGATIVE POLL DELAY IS CHANGED TO 1000 FROM 960 


3. ENTER: CSMT NEGP,INQCURY, TERMID=nnnn 
RECEIVE: NEGATIVE POLL DELAY IS 960 


Turn the CICS trace function cn or off 
Definition: Used in conjunction with on or off to start or stop 


logging entries in the Trace Table. Current status cf trace (on 
or off) cannot be inguired about. Examples are: 


1. ENTER: © CSMT TRACE 
RECEIVE: IS TRACE FACILITY TO BE TURNED ON OR OFF ? 
ENTER: OFF 
RECEIVE: TRACE FACILITY IS NOW DISABLED 
2. ENTER: CSMT TRACE,ON 
RECEIVE: TRACE FACILITY IS NOW ENABLED 


Stall time interval 


Definition: Inquire about or change the value of the stall time 
interval. Typical stall time interval might be 20000 milliseconds. 
Examples are: 


1. ENTER: CSMT STALL 

RECEIVE: WHAT IS THE NEW STALL INTERVAL VALUE 

ENTER: 15000 | 

RECEIVE: STALL INTERVAL IS CHANGED TO 150C0 FROM 20000 
2. ENTER: CSMT STALL, INCURY 

RECEIVE: STALL INTERVAL IS 15000 
3. ENTER: CSMT STALL 

RECEIVE: WHAT IS THE NEW STALL INTERVAL VALUE 

ENTER: CANCEL, 


RECEIVE: CANCEL REQUESTED BY TERMINAL OPERATOR 


Trigger level for a Transient Data intrapartition data set 


Definition: Specifies the number of data records (trigger ievel} 
to be accumulated for a destination before automatically requesting 
the creation of a task to process these records. Examples are: 


1. ENTER: CST 

RECEIVE: WHAT SERVICE IS REQUESTED? 

ENTER: TRIGGER 

RECEIVE: ENTER 

DESTINATION ID 

ENTER: DESTID=DCIN > 

RECEIVE: WHAT IS THE NEW TRIGGER LEVEL VALUE 

ENTER: 006 7 

RECEIVE: TRIGGER LEVEL IS CHANGED TO 6 FROM 5 
2. ENTER: CSNT INQUKY, TRIGER, DESTID=DCIN 


RECEIVE: TRIGGER LEVEL IS CHANGED TO 6 FROM 6— 
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Open oar close cne or more Transient Data extrapartition data sets. 


Definition: © 


Used during real time execution to open or close one 
Or more extrapartition data sets. 


Gives the CICS Master Terminal 


the ability to dynamically open or close these data sets. Exanples 
are; 
1. ENTER: CSMT TRANSD 
| RECEIVE: $$ WHAT SERVICE IS REQUESTED? 
ENTER: OPEN : | 
RECEIVE: SPECIFY DESTINATION I.D.'S 
ENTER: DESTID=XDK1..S6,XDK2. .DY,XTDA, XTDB,XDK3.. DY, XXXX 
RECEIVE: SPECIFY OVERRIDES FOR DESTID XDK3 
ENTER: OVPARM=INPUT, 2,VB,,40,80, TDXDK3I 
RECEIVE: SPECIFY OVERRIDES FOR DESTID XDK2 
ENTER: OVPARM=OUTPUT, , FBS, ,40,120,TDXDK20 
RECBIVES .XXXX CAN NOT BE OPENED 
XDK3..DY HAS BEEN OPENED 
XTDB HAS BEEN OPENED 
XTDA HAS BEEN OPENED 
XDK2..DY¥Y HAS BEEN OPENED 
XDK1..S6HAS BEEN OPENED 
+# END 4% 
2. ENTER: CSMT CLOSE, DESTID=XDK1..S6,DK2..DY¥,XTDA,XTDB,XDK3, 
X XXX 
RECEIVE: WHAT TYPE OF DATA SETS ARE BEING CLOSED (DATABASE, 
TRANSDATA, OR DUMP). 
ENTER: TRANSIENT DATA 
RECEIVE: XXXX CAN NOT BE CLOSED 
XDK3 HAS BEEN CLOSED 
XTDB HAS BEEN CLOSED 
XTDA HAS BEEN CLOSED 


XDK2..-DY HAS BEEN CLOSED 


XDK1..S56 HAS BEEN CLOSED 
*eENDEX 


Open, close, 


Definition: Used during real-time execution to switch, close or 
open the dump data set. Gives the master terminal operator the 
ability to obtain CICS dumps taken during prior processing. 
Exaaples are; 


or switch the dump data set. 


1. ENTER: CSMT OFEN,DUMP 

RECEIVE: -DFHDMPA IS NOW THE ACTIVE DUMP DATASET 
2. ENTER: CSMT SWITCH 

RECEIVE: DFHDMPB IS NOW THE ACTIVE DUMP DATASET 
3. ENTER: CSMT SWITCH 

RECEIVE: DFHDMPA IS NOW THE ACTIVE DUMP DATASET 
4. ENTER: CSMT SWITCH 

RECEIVE: DFHDMPB IS NOW THE ACTIVE DUMP DATASET 
5. ENTER: CST DUMP,CLOSE 

RECEIVE: DUMP DATASET NOW CLOSED 


Pe 


Open or clcse one or more data base data sets. 


Definition: 
portions of the data base offline or online to real-time procesSing. 


If all files are specified, 
first line entered. 
of the data f-ase data sets. 


1. 


3. 


ENTER: 
RECEIVE: 
ENTER: 
RECEIVE: 
ENTER: 
RECEIVE: 


ENTER: 


RECEIVE: 


ENTER: 
RECEIVE: 


ENTER: 
RECEIVE: 


ENTER: 
RECEIVE: 
ENTER: 
RECEIVE: 
ENTER: 
RECEIVE: 


ENTERS: 
RECEIVE: 


ENTER: 
RECEIVE: 


Allows the terminal operator to place all or selected 


the keyword ALL must be used in the 
The operator can also inquire about the status 
Examples are: 


CSMT DATBAS 

PLEASE SPECIFY FILE I.D.'S 
OPEN 

PLEASE SPECIFY FILE 1I.D.°'S 
FILEID=LBASE1, DEASE2, XXXX 
NEW DATA BASE STATUS IS: 


FILE ID ---- --- STATUS -------- 
XXXx ka} CES NOT EXIST 
DBASE2 OPEN, READ 


DBASE1 OPEN, READ 
**e*x END *X 


CSMT OPEN, DATBAS,ALL 
NEW DATA BASE STATUS IS: 


FILE ID -------- STATUS -------- 
(a complete list of all files and their status) 


**e END A 


CSMT CLOSE, FILEID=DBASE1, DBASE2, XXXXX 

WHAT TYPE OF LATA SETS ARE BEING CLOSED? (DATABASE, 
TRANSDATA OR DUMP). 

DATABASE 

NEW DATA BASE STATUS IS: 


FILE [) =+44=<+<= SLATUS eS e== 
XXXXKX **DOES NOT EXIST 
DBASE2 CLOSED,READ 

DEASE1 CLOSED,READ 

**END** 


CSMT DATBAS 

PLEASE SPECIFY FILE I.D.'S 
FILEID=DBFILE 

SPECIFY ACTION (ON OR OFF) 

ON 

SPECIFY FUNCTION TO BE CHANGED 
(READ, ADD, UPDATE, EXCLSV) 

READ 

NEW STATUS OF SPECIFIED FILE IS: 


FILE ID -------- STATUS -------- 
DBPILE OPEN, READ, EXCL 


CSMT DATBAS,ON, FILEID=DBFILE 
NEW STATUS OF SPECIFIED FILE IS: 


FILE ID -------- STATUS -----~-- 
DBFILE OPEN, READ, EXCL 


Status of a program (inquiry only) 


Definition: 


Inquire about the status of a program. 


Used to verify 
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the status of a program before attempting to alter the prograr or 


system. Exagples are: 


1. 


Terminate a task that is attached to a specific terminal. 


ENTER: 
RECEIVE: 
ENTER: 
RECEIVE: 


ENTER: 
RECEIVE: 


ENTER: 
RECEIVES 


ENTER: 
RECEIVE: 


Definition: 


to ke terminated is encumbering system resources. 


Vs 


Inquire about or change the status of a control unit (not applicable 


ENTER: 
RECEIVE: 
ENTERS 
RECEIVE: 


ENTER: 
RECEIVE: 


ENTER: 
RECEIVE: 


CSNT 

WHAT SERVICE IS REQUESTED? 
PROGRAN 

ENTER 

PROGRAM ID 


- PGRMID=DFHMTPA 


PROGRAM DFHMTPA IS WRITTEN IN ALC, 
IT IS 4040 BYTES LONG, 

PERMANENTLY CORE RESIDENT, 

IT HAS REEN USED 000016 TIMES, 

AND ITS CURRENT USE COUNT IS 0 


CSMT PGRM,PGRMIC=FCO01 

PROGRAM FCOO1 IS WRITTEN IN PL/I, 
IT IS 9128 BYTES LONG, 

NOT PERMANENTLY CORE RESIDENT, 

IT HAS BEEN USED O TIMES, 

AND ITS CURRENT USE COUNT IS 0 


CSMT PGRM,PGRMID=HLLOO1 

PROGRAM HLLOO1 IS WRITTEN IN COBOL, 
IT IS 03C8 BYTES LONG, 

NOT PERMANENTLY CORE RESIDENT, 

IT HAS BEEN USED 0 TIMES, 

AND ITS CURRENT USE COUNT IS 0 


Used to terminate a task on a terminal where the task 
Examples are: 


CSMT TRMNAT 

ENTER TERMINAL ID 
TERMID=XXXX 

TASK WAS NOT ACTIVE 


CSMT TRMNAT,TERMID=L60B 
TASK WAS ACTIVE 


CSMT TRMNAT, TERNID=L60B 
TASK HAS TERMINATED 


to TCAM terminals). 


Definition: 


contrcl unit. 


in 


te 


service. 


ENTER: 
RECEIVE: 


ENTER: 
RECEIVE: 


Inquire about or change the service status of a remote 
This function can be used to place all the terminals 
associated with that particular control unit to out of service or 

i Examples are: 


CSHT CNTRL,INCURY, TERNID=NNNN 
CCNTROL UNIT 
OUT OF SERVICE 


CSST CNTRL,INSRV, TERMID=NNNN 
CCNTROL UNIT 
IN SERVICE 


Definition: 


only be enacted Ly a master terminal operator. 


1. 


t. 


ENTER: 
RECEIVE: 
ENTER: 
RECEIVE: 


ENTER: 
RECEIVE: 
ENTER: 
RECEIVE: 


ENTER: 
RECEIVE: 
ENTER: 
RECEIVE: 


ENTER: 
RECBIVE: 
ENTER: 
RECEIVE: 


Inquire about 


Definition: 
to change it 


1. 


2. 


De 


ENTER: 
RECEIVE: 


ENTER: 
RECEIVE: 


ENTER: 
RECEIVE: 


ENTER: 
RECEIVE: 


ENTER: 
RECEIVE: 


ENTER: 
RECEIVE: 


Terminate CICS. 


Shutdown or suspend all CICS terminal operation. 


CSMT SHUTDN 


_.IS SHUTDOWN TO BE IMMEDIATE? 


CANCEL 


Examples are: 


Can 


SHUTDOWN REQUEST HAS BEEN CANCELED BY THE OPERATOR 


CSMI SHUTDN 

IS SHUTDOWN TO BE IMMEDIATE? 

NO 

DH1701 - CICS IS BEING TERMINATED 


CSMT SHUTDN 

IS SHUTDOWN TO BE IMMEDIATE? 
YES, DUMP 
DPH1701 - CICS IS BEING TERMINATED 
CSMT SHUTDN 

IS SHUTDOWN TO BE IMMELCIATE? 

NO 


SHUTDCWN ALREADY IN PROGRESS 


Or change the status of tersinals. 


's 


Used to inguire about the status of a terminal, or 


status. Examples are: 


CSMT TERMNL,SINGLE, INQURY,TERMNID=L60A 
STATUS fs 

IN SERVICE 

TRANSACTION 


CSMT TERMNL,SINGLE, INSEV, TERMID=L60B 
STATUS IS 

IN SERVICE 

TRANSCEIVE 


CSMT TERMNL, SINGLE, OUTSRV,DISPLY, TERMID=L60C 
STATUS IS 

OUT OF SERVICE 
TRANSCEIVE 

TRANSACTION ID IS CSSN 
ENTER 

INTERCEPT 

TERMINATE 

SUSPEND 

TERMINATE 

STATUS IS 

OUT OF SERVICE 
TRANSCEIVE 

TASK WAS 

TERMINATED 


CSMT TERMNL, LIST, INSRV,TERMID=TMO1, ABCD 
TERHINAL IDS 
STATUS IS CHANGED 


CSHT OUTSRV, TERMNL, TRMNAT,CLASS,CLASID=02 
TERMINAL IDS 
STATUS IS CHANGED 
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5 TASKS WERE ACTIVE 
5 TASKS WERE TERMINATED 


6. ENTER: CSHT TERMNL,INSERV, ALL 
RECEIVE: TERMINAL IDS 
STATUS IS CHANGED 


7. j§ENTER: CSMT TERMNL, LIST, TRNCV,TERHID=TREA,TRAB, TRAM 
RECEIVE: ‘TERMINAL IDS 
STATUS IS CHANGED 


lu. Inquire about or change the service status of a line. 


Definition: Used to inquire about the service status of a line, 
or to change the service status of the line. Examples are: 


1. ENTER: CSMT LINE, INQURY, TERMID=XXYY 
RECEIVE: LINE 
OUT OF SERVICE 


2. ENTERS CSMT LINE, INSRV,TERMID=ZZXX 
RECEIVE: LINE : | 
: IN SERVICE 
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PASSWORD FIELD ERROR 
Exelanation: "“PS=" is not in positions 6-8. 
System Action: The sign-on transaction is terminated. 


QOgrerator Response: Reenter the sign-on transaction. 


NAME FIELD NOT FOUND 
Explanaticn: "NAME=" is not found in positions 14-18. 
System Action: The sign-cn transaction is terminated. 


Operator Response: Reenter the sign-on transaction. 


NAME ERROR 


Explanation: The entered operator name is not in the Sign-on 
Table. 


System Action: The sign-on transaction is terminated. 


Qperatoy Response: Verify the entered name. If the name is 
incorrect, reenter the transaction with the correct name. if 
the name is correct, contact the CICS system programmer. 


FASSWORD ERROR 


Explanaticn: Incorrect password. The password is assigned at 


the time the Sign-on Table is generated by the user. 
System Action: The sign-cn transaction is terminated. 


Orerator Response: Verify the entered password. If the password 
is incorrect, reenter the transaction with the correct password. 
If the password is correct, contact the CICS system programmer. 


TRANSACTION HAS BEEN ABNORMALLY TERMINATED 


Explanation: An abnormal condition has been detected in the 
processing of the transaction; it has been determined to be 
unwise or impossible to continue processing the transaction. 


System Action: The transaction has been terminated. 


Operator Response: Operator action must be determined by the 
user as different transactions and applications will likely 
require different treatment. If not specifically instructed 
how to handle this condition, it is suggested that the person 
in charge be notified. 
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TRANSACTION xxxx PURGED - SYSTEM UNDER STRESS - PLEASE RESUBMIT 


Explanaticn: The system is approaching an overload condition; 
it has been determined necessary to reduce the activity in the 
System in order to recover. xxxx represents a four-character 

transaction identification. 


System Action: The identified transaction has been automatically 
terminated (purged) from the systen. 


Operator Response: Under most circumstances, the transaction 
can be resubmitted successfully as soon as the system makes the 
invitation. 


INVALID TRANSACTION IDENTIFICATION ~ PLEASE RESUBMIT 


Exgelanatign: The transaction code does not match an entry in 
the Program Ccntrol] table. 


System Action: CICS continues the polling cycle and repolls 
the terminal. 


Operator Respgnse: Enter the proper’ code, followed by the 
message. | 


MESSAGE TCC LONG, PLEASE RESUBMIT 


Exglanaticn: The message has exceeded the maximum length 
allowed, cr in the case of data that is treated sequentially 
from a sequential device (card reader, disk, tape), a 0-2-8 
punched card code or the equivalent is missing following the 
input data. 


System Action: None. - 

Qpskator Response: Shorten the message and reenter it or enter 
the message in two parts. If the message is entered in two 
parts and if the data is treated sequentially from a sequential 
device (card reader, disk, tape), place a 0-2-8 punched card 
code or the equivalent follcwing the input data. 

OEFERATOR HAS NOT SIGNED ON ~- PLEASE SIGN ON 

Exglanaticn: The terminal has not been signed on. 

System Action: Continues the polling cycle. 

Qperatagr Besponse: Sign on to the system using transaction 
CSSN. 

SECURITY KEY VICLATION HAS BEEN DETECTED 


Explanation: The operator has requested a transaction which is 
not available to that operator. 


System Action: Continues the polling cycle and notifies the 
master terminal cperator at destination CSMT. 


Operator Responsg: Determine whether the operator is to be © 
allowed to request the transaction. If so, correct the security 
key for the operator in the Operator Sign-on Table. 


11. 


12. 


13 


14. 


START SYMBOL MISSING 


Explanation: Applicable to all 2260/2265 terminals. Either 
the START symbol was not present on the screen when ENTER was 
hit or the cursor was immediately in front of the start symbol 
when ENTER was hit. 


System Action: None. 


or Response: Place the start symbol in the proper position 


at 
reenter the message. 


AUTOMATIC OUTPUT IS BEING REQUESTED 


Explanaticn: This is the first message associated with automatic 
output on a buffered terminal, such as the 2740 Model 2. 


System Action: A transaction is attached to the terminal and 
autcmatic outrfut fcllows this message. 


Operator Response: Data should not be keyed until the automatic 
output transaction has terminated. 


Note: When data is being keyed and the attention light turns 
On, an attempt is being made to write a message to' the 
terminal. If the write operation is associated with a 
transaction, the buffer must be reset to allow the 
message to print. If the "automatic output is being 
requested" message turns on the attention light, the 
operator can continue keying data since polling will 
occur for 26 seconds before another attempt is made to 
Write the message again. 


READY 


Explanaticn: Applicable only to switched lines with terminal 
"answerback", this message is the response to a ccrrect terminal 
identification when the terminal oferator has keyed the 
four-character terminal identification as the first entry of 
data after establishing the line ccnnection. 


System Action: A line event iS initiated by Terminal Control. 


a ER ee RD a ee ave <a ce ab 


Operator Response: Start keying a transaction. 


INVALID TERMINAL IDENTIFICATION 


Explanaticn: Applicable only to switched lines with terminal 
Nanswerback", this message indicates that the terminal 
identification code does not match a terminal identification 
entry in the terminal pool associated with the line. 


System Action: The line is disconnected. 
Operator Response: Key the four-character terminal 


identification as the first data entry after establishing the 
terminal connection. 
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TERMINAL CUT OF SERVICE 


Explanaticn: Applicable only to switched lines with terminal 
"answerback", this message indicates that although the terminal 
1ijientification is valid, the terminal is out of Service and 
cannot be used to initiate transactions or receive output. 


System Action: The line is disconnected. 


: After the terminal is placed back in service, 
n retry the line ccnnection. 


TERMINAL IN USE 


Explanaticn: Applicable only to switched lines with terminal 
"answerback", this message indicates that although the terminal 
identification is valid, the terminal is lcgically connected to 


another line or is in use by another operator. 


System Action: The line is disconnected. 


Operator Action: Determine the proper terminal identificaticn 


OEP cen amen aC em END > de ee aD ame ae 


and retry the line ccnnection. 


If the operating terminal is communicating with a 7770, the 
Nerror message" will be returned for items 5 through 10 and 14 
through 16 above. Therefcre, the operator response should take 
into consideration all these items. The “ready message" will 
be returned for item 13 above. 


MESSAGES RETURNED TO TERMINAL OPERATOR 


1. 


DFH1029 PLEASE RESEND 

Explanation: This message is sent to 2980 terminal operators 
when the system is under stress or the input is unsolicited. 
(The active task associated with the terminal has not issued a 
read.) 

System Action: None. 


Qperator Action: Resubmit data. 


DFH1941 UNRECOGNIZED FIELD IN CRDR MSG 


Explanaticn: At least one of the fields in the CRDR statement 
cannot be interpreted. 


System Action: This message is followed by the DFH1947 message. 


Operator Action: Examine the CRDR statement for incorrect syntax 


AD ie SE ae OE nt agen ee A ee 


or spelling errors. Correct any errors and enter the request 
again. 

DFH1942 ATP IS NOT SUPPORTED 

Explanaticn: CRDR was requested but ATP=NO was specified either 


in the System Initialization Table (SIT) cr during system 
generation. 


System Action: This message is followed by the DFH1947 message. 


CICS must ke restarted with the ATP runction 


DFH1943 PARAMETER HAS AN IMEROPER LENGTH 


Explanation: One of the keyword parameters is either too long 


or does not exist (for example, EXIT, DELIM=AB). 
System Action: This message is followed by the DFH1947 message. 


Operator Action: Same as DFH1941., 


DFH1944 BATCH WOULD CAUSE A DUPLICATE NAME 


Explanaticn: Another batch originating from this terminal 
already exists within CICS. 


System Acticn: This message is followed by the DFH1947 message. 


Operator Action: Resubmit the CRDR statement specifying a 


different batch name. 
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11. 


DFH1945 INSUFFICIENT CORE AT THIS TIME 


Explanation: Currently there is not enough storage to provide 
a buffer for the batch. Submit the batch later. 


System Action: This message is followed by the DFH1947 message. 


Operator Action: Wait a short time and resubmit the batch. 


DFH1946 EXIT EFROGRAM DOES NOT EXIST 

Explanaticn: The requested exit program could not be located. 
System Action: This message is followed by the DFH1947 message. 
Qperator Action: Verify that the exit program actually exists 
in the prcgram library and is identified in the Processing 
Program Table (PPT). 

DFH1947 ENTER STOP TO TERMINATE CRDR 

Explanation: An error has been detected by CRDR. The operator 
must either submit a message having STOP as its first four 
characters or the uniquely defined delimiters for this batch in 


order to terminate CRDR. 


System Action: When STOP or the batch delimiter(s) has been 
entered, CRDR will terminate. 


Operator Action: Correct any errors and resubmit the batch. 


DFH1948 DISK QUEUE IS EXHAUSTED 


Explanation: The Transient Data Intrapartition data set is 


So RD A aio 


full. The batch causing the message will be deleted. 


System Action: This message is followed by the DFH1947 message. 


Operator Action: Wait a short time and resubmit the batch. If 


the error persists, notify the system administrator so that 
action can be taken to relieve the Transient Data queue load. 


DFH1949 DATA KECORD TOO LARGE 


Explanation: A record has been passed to CRDR that wails not 


fit in the Transient Data buffer. The batch causing the message 
will be deleted. 


System Action: This message is followed by the DFHI947 message. 


: Determine the reason for the large record or 
buffer size is correct. 


DFH1950 BATICH 3XXXXXXX RECORD CCUNT-NNNNN 


Explapaticn: CRDR has completed processing the named batch. 
The record ccunt includes delimiters and records inserted by 
the exit routine. The initial CRDR message is not included in 


this count. 


12. 


13. 


4. 


16. 


System Action: No action is required. 


—— a see ee eee wae cue cone 


Operator Action: Nc action is required. 


«op 


DFH1951 BATCH HAS BEEN DELETED 


Explanation: The DELETE service was reguested in last delimiter 


RP GOES eee cote cues mae eee 


statement. 
System Action: No action is required. 


Operator Acticn: No acticn is required. 


System Action: No action is required. 


Operator Action: No action is required. 


DFH1960 BATCH ¥XXXXXXX STATUS QUEUEING AREA FULL 
READY FOR PROCESSING 
BEING PROCESSED 
READY FOR OUTPUT 
BEING SAVED 
AWAITING DELETION 
BATCH BEING HELD 


Explanation: The status of a batch was requested. More than 


one message may apply to any one batch. 
System Action: No action is required. 


me ores erm tere ase evr GERD of yan aco 


Operator Action: No action is required. 
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Explanation: CWIR was requested but ATP=NO was defined either 


ae ee ee ee ome 


in the System Initialization Table or during system generation. 
System Action: The CWTR request is ignored. 


CIcS must ke restarted with the ATP function 


DFH1962 BATCH XXXXXXXX STATUS UNKNCWN OR FROTECTED 


Explanation: Output or status was requested from the batch 


named; however, the batch cculd not be located or was password 
protected. 


System Acticn: This particular request of CWTR is ignored. Any 


oe same uae see eee cum RIP QOS CED CINE eaten GED 
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17. 


18. 
19. 
20. 


21. 


226 


23. 


24. 


DFH1963 KEYWD XXX¥XX STATUS-UNRECOGNIZED SYNTAX 


Exglanation: At least one of the parameters on the CWTR 
statement could not be interpreted. 


System Action: The CWTR request is ignored. 
Operator Action: Examine the CWTR statement for incorrect syntax 


ox spelling errors. Correct the errors and enter the request 
again. | 7 


DFH1964 BATCH YIXXXXXX STATUS-SAVED PER REQUEST 
DFH1965 BATCH XXXXXXXX STATUS-DELETED PER REQUEST 
DFH1966 BATCH AXX¥XXXX STATUS-RELEASED PER REQUEST 


Exglanaticn: This message acknowledges action on the user's 
reguest. 


System Action: The reguest has been honored. 


Operator Action: No action required. 


DFH1967 BATCH X¥XXXX¥XX STATUS-EXIT YY NOT FOUND 

Explanaticn: A CWIR exit routine, DFHXITyy, was requested but 
cculd not Ee located in the Processing Program Table (PPT). The 
request fcr output is ignored. 

System Action: This particular request of CWTR is ignored. Any 
other valid requests are processed as well as any previously 
submitted requests for output still outstanding. 


Qperator Acticn: Verify that the exit program actually exists 


in the pregram likrary and that it is identified in the 
Processing Program Table (PPT). 
DFH1968 BATCH XX¥XXXXXX STATUS-~NOT YET READY 


Explanation: Output has been requested from the named batch 
but processing is not yet completed. 


System Acticn: Same as for DFH1962 message. 

Operator Action: No action required. The request for output 
has been posted and will occur when the processing of the batch 
is completed. : 


DFH1969 BATCH OUTPUT STATUS-NOTHING PENDING NOW 


Explanation: Nothing is available to be transmitted in response 
to the last request. | 


System Action: None. 
Operator Action: No action required. 


DFH1970 BATCH XX¥XXXXX STATUS-DUP ACTION REQUESTED 


Explanation: The output service has been previously requested. 
This request is ignored. 


25. 


System Action: Same as for DFH1962 message. 
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No action reguired. 


DFH1971 BATCH XXXXXXXX STATUS-INVALID OUTPUT OPER 


Explanation: The transaction program has requested a terminal 
output service not supported by CWTR. 


System Action: The record, which fcllows this message, was 
written by the transaction program uSing an output request that 
js not support by ATP; for example,, DFHTC TYPE=DISCONNECT. The 


message is transmitted ignoring the invalid action. 


Operator Action: No action required. 


os 


MESSAGES KETURNED TO MASTER TERMINAL (DESTINATION CSMT) 


The following messages are sent to the Transient Data destination 


CSMT by the Asynchronous Transacticn Control Program (DFHATP) 
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1. DFH1901-XXXX INVALID OUTPUT DESTINATION, BATCH=YYYYYYYY, 
TERM=Z2222 


Explanation: Four (4) X's identify the terminal destination 
where output frem batch YYYYYYYY was to be transmitted as per 
user request. When ATP attempted to schedule a CWTR task for 
that terminal, it found the terminal to be non-existent in the 


TCT. 2Z22Z is the identification of the terminal which originated 


the batch. 


A valid CWTR request must be submitted before output is 
transmitted. 


2- DFH1902 ~ TRUNCATED OUTPUT FOR BATCH XXXXXXXX, TERM YYYY, XACTN 


CODE 2222 


Explanation: The transaction program, 2Z22Z, attempted to write 
a record that was tco long for the output buffer. The 
transacticn program was operating on the batch, XXXXXXXX, that 
originated from terminal YYYY. 


System Action: The message was truncated and processing is 
allowed tc continue. Subsequent messages in this batch that 


are too lcng will also be truncated but this error message will 


not ke repeated. 

ffer. 

Ss DFH1903 - BATCH XXXXXXXX, TERM YYYY, SUSPENDED-OUTPUT QUEUE 
EXHAUSTED 


Explanation: The Transient Data intrapartition area is full. 


: Processing of the katch, XXXXXXXX, that 
rom terminal YYYY has been suspended. 


Operator Action: Wait a short while and release the batch to 
resume processing using the statement CWTR NAME=XXXXXXXX, 
RELEASE. In this condition persists notify the system 


administrator so that some action might be taken to relieve the 


strain on the intrafartition queue area. 


Determine the reason for either the long record 


Listed below are the functional keywords acceptable to the Mastery 
Terminal. Indicated for each function is the keyword (that must be 
used if used in the original data entry) and the meaning. 


Function 


ADD 


ALL 


BATCH MAXIMUM 
TASKS 


ATP MAXIMUM 
TASKS 


CANCEL 


CLASS 


CLOSE 


CONSECUTIVE 
DISPATCH LIMIT 


CCNTROL UNIT 


CUSHION 


ALL 


BMAXT 


ATEMXT 


CANCEL 


CLASS 


CLOSE 


CDL 


CNTRL 


CUSH 


Allows records to be added to the 
data base data set. 


Changes the status of all terminals 
if associated with keyword TERMINAL. 
However, processing status cannot be 
Changed using this keyword. If used 
With keyword DATA BASF, will inquire 
about or change status of all data 
base data sets. 


Inquire about or change the maximum 
number of tasks which is a 
combination of regular terminal 
tasks and ATP batch tasks. (Not 
provided for under CICS/DOS-ENTRY.) 


Inquire about or change the maxiiun 
ATP tasks. This value must be equal 
to or less than BMAXT. (Not provided 
for under CICS/DOS ENTRY). 


Nullifies and terminates the master, 
Supervisory, or Single terminal 
Operator request. 


Indicates that the service status 
of a group of terminals defined by 
a Terminal List Table (TLT) is to 
be changed. 


Used to close data files, transient 
data extrapartition data sets and 
the dump data set(s). 


Valid only in the CICS/DOS-ENTRY, 
sets a limit te number of input/ 
output operations performed by a 
transaction. Can be any value 
between 1 and 999. 


Inquire about or change the service 
Status of a remote 2848 Control 
Unit. 


Changes the storage cushicn to 
minimize overload conditions. 
However, cushion size does not 
actually change until existing 
cushion is released. When cushion 
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CWTR 


DISPLAY 


DUMP 


EXCLUSIVE 
CONTROL 


DATA BASE 


INQUIRY 


IN SERVICE 


INTERCEPT 


LINE 


LIST 


MAXIMUM 
TASKS 


NEGATIVE POLL 


OFF 
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CWTR 


DSPLY 


DUMP 


EXCLSV 


DATBAS 
INQURY 


INSRV 


INTRCP 


LINE 
List 


MAXT 


NEGP 


OFF 


TP ED cate a EG 


is regained, the cushion will be 
the size indicated by the new value. 


Calls the asynchronous transaction 
cutput processor for the purpose of 
displaying or modifying password 
protected batches. 


When putting a single terminal out 
of service, displays transaction 
I.D. of any task that may be 
associated with that terminal. 


Open or close the dump data set or 
Switch the dump data set, if two 
were specified. 


One possible status of a data base 
data set. When used, CICS File 
Control Pregram prevents Simultaneous 
updates of the same logic record 
Within a data set. Without this, 
protection is not provided. 


Open, close, inguire about, or change 
the status of cne or more data base 
data sets. 


The requested service is an inquiry. 
If this keyword is not entered, a 
change is assumed. 


One possible service status of a 
line, control unit, or terminal. 


When putting a single terminal (which 
has an associated task) out of 
service, attaches the requesting 
terminal to the task for completion 
(not provided for CICS/DOS-ENTRY). 


Specifies that a service status 
function is to be performed ona 
line. 


Change the status of a group of 


terminals that are specified by 
TERMID=.,. 


Inguire about or change the limit 
of the number of tasks that can 

be active in the CICS system at any 
one time. The range is from 

1 to: 999. (Not provided for 
CICS/DOS-ENTRY.) 


Inquire about or change the negative 
poll delay for a terminal. 7 


When associated with the keyword 
TRACE, turns off the CICS trace 


Function 


CN 


OPEN 


CUT OF SERVICE 


PROGRAM 


READ 


RECEIVE 


RUNAWAY 


SHUTDOWN 


SINGLE 


STALL 


SUSPEND 


SWITCH 


TERMINAL 


TERMINATE 


ON 


OPEN 


OUTSRV 


PGRM 


READ 


RECV 


RNAWAY 


SHUTDN 


SINGLE 


STALL 


SUSPND 


SWITCH 


TERMNL 


TRMNAT 


facility. When associated with DATA 
BASE, turns off the indicated status. 


When associated with the keyword 
TRACE, turns on the CICS trace 
facility. When associated with DATA 
BASE, turns on the indicated status. 


Applicable only to extrapartition 
destinations usSing resident data 
sets. Specifies how the data set 
associated with this destination is 
to be opened. 


One possible service status of a 
line, control unit, or terminal. 


Inquire about the status of a 
program. 


One possible type of service request 
that can be processed against a file 
data set. Allcws records to be read 
from this data set. 


One of three possible processing 
statuses of a terminal. 


Inquire about or change the time 
that a test can be in a runaway 
(loop) condition. Typical runaway 
time interval might be 5000 
milliseconds. 


Terminate CICS. 


Inquire about or change the status 
of a single terminal. 


Inquire about or change the value 

of the stall time interval. Typical 
stall time interval might be 20000 
milliseconds. 


When putting a line, control unit, 
or terminal(s) out of service, 
suspend any task which is attached 
to the terminal (s). 


Close the current dump data set and 
open the alternate dump data set. 


Indicates that Service is requested 
for a terminal function. The 
terminal function will need to be 
further defined. 


When putting a line, control unit, 
or terminals out of service, 

terminate any task associated with 
the terminal(s). When not associated 
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Function 


TIME 


TRACE 


TRANSACTION 


TRANSCEIVE 


TRANSIENT DATA 


TRIGGER 


UPDATE 
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Keyword 


TIME 


TRACE 


‘TRNACT 
TRNCV 
TRANSD 


TRIGER 


UEDATE 


t 


Meaning 


with any other keywords, terminate 
a task on a specific terminal. 


Sets the saximum time interval in 
milliseconds that CICS will release 
control to OS in the event there 
are no transactions ready to resume 
processing. Typical time interval 
might be 1000 milliseconds. 


Used in conjunction with on or off 
to start or stop logging entries in 
the trace table. 


One possible processing status of 
a terminal. | 


Qne possible processing atatus of 
a terminal. 


Qpen or close one or more Transient 
Data extrapartition data sets. 


Specifies the number of data records 
(trigger level) to be accumulated 

for a destination before 
automatically requesting the creation 
of a task to process these records. 


One possible type of service request 
that can be processed against the 
data set. Allows recorda to he 
updated on this data set. 


AEPENDIX B: 


Below is a list of keyword equal parameters and their functions that 
must be entered in CICS to correctly identify the particular names cr 


wariables requested. 


Parameter List Keyword 


—_ eg 


TERAID 


FILEID 


PGRAID 


DESTID 


CLASID 


SU PRID 


CVPARM 


Function 


Used to specify the unique 
four-character symbolic terminal 
identifications that are generated 
in the Terminal Control Table (TCT) 
by the user to identify each 
terminal. 


Specifies the symbolic data set 
names for the data sets that are 
defined in the File Ccntrol Table 
(FCT) . 


Specifies the program name as defined 
in the Processing Program Table 
(PPT) . 


Specifies the symbolic names of the 
destinations for extrapartition data 
sets as defined in the Destination 
Control Table {DCT). 


Specifies the one- or two-character 
suffix attached to DFHTLT to load 

a list of symbolic terminal 
identifications previously defined 
in a Terminal List Table (TLT). The 
list refers to a class of terminal. 


Specifies the one- or two-character 
suffix attached to DFHTLT to load 

a list of symbolic terminal 
identifications previously defined 
in a Terminal List Table (TLT). The 
list refers to the terminals under 
control of a supervisory terminal. 


Applicable only to CICS/OS, specifies 
the parameters to be used to build 

a DCB (which is opened with the 
specified destination ID). These 
parameters are positional; if any 
leading parameters are omitted, 

their absence must be indicated with 
accmma. The parameters must be 
entered in the order indicated below: 


A. OPEN Opticn 


1. OUTPUT 

2. INPUT 

3. RDBACK 
B. BUFNO 


Value between 1-255 


G3 


Parameter List Keyword 


HY 


Function 


C. RECFM 
F - Fixed 
V - Variable 
U - Undefined 
FB -~ Fixed blocked 
VB - Variable blocked 
FS - Fixed standard 
VS - Variable spanned 
FBS - Fixed block standard | 
VBS - Variable blocked spanned 


FA - Pixed ASA control 
VA - Variable ASA ccntrol 


UA -~ Undefined ASA control 

FM - Fixed machine control 

VM - Variable machine control 

UM - Undefined machine control 

FBA - Fixed blocked ASA control 

FBM - Fixed blocked machine 
control 

VBA - Variable blocked ASA 
control 

VBM - Variable blocked machine 

control 

FBSA ~ Fixed blocked standard 
ASA 

FBSA - Fixed blocked standard 
machine 

VBSA - Variable blocked spanned 
ASA 

VBSM ~ Variable blocked spanned 
machine 

EROPT 

1. IGNORE ~- Accept error (ACC) 

2. SKIP ~ Skip error (SKP) 

LRECL 


1. Numeric vaiue maximum 32,760 
bytes 


BLKSIZE 


1. Numeric value maximum 32, 766 
bytes | 


DDNAME 


1. Up to eight (8) characters 
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INDEX 


This index has been prepared by an autumated 
indexing program. The intent is to list primary 


page references first. Your comments and 
suggestions will be appreciated. 


~A- 


ANBREVIATED KEYWORD 17-18 
ADD 19,1,25 
ALTER 15,26 
ANSWERHACK =. 31-32 
ATP =-:'18, 33, 35, 37 
ATP BATCH TASKS. 39 
ATP BATCHES 
MAXIMUM NUMBER OF 21 
ATP PUNCTTON 33,35 
ATP MAXIMUM 39 


DUMP DATA SET 
ALTERNATE 
DUMP DATASET 


17,24,40, 39 
17,41 
24 


END 6, 24-25, 14 
RRROR 33-34, 36,44 


ERROR MESSAGE 


EXIT 10-13,33 


EXIT PROGRAM 


5,7,32, 38 


34, 36 


FILEID 25,43 
ATP MAXIMUM TASKS 21,19 
ATP TASKS DESIGNATION 
MAXTMUM NUMBER OF 21 -H- 
ATP TASKS VALUE 
MAXIMUM NUMBER OF 17 
“ATPMXT RECEIVE 21 HOLD 11-12 
456 6 HOLD STATUS 13 
HOLD/DELETE BATCHES 11 


-~B- 
-I- 

BATCH 

DURING SUBMISSTON OF A 12 INPUT 4, 13-14, 9-11, 33 

INPUT OF THE 11 INPUT DATA 30,11 

NAM® OF THE 11-12,33, 35 INQUIRY 40,1, 18,25 

STATUS OF A 22255 INQURY 26~-28,18,23,40 
BATCH DELIMITER 11,34 INSERV 28 
BATCH MAXIMUM 39 INSRV 26-28, 16,40 
BATCH MAXIMUM TASKS 19,22 INTERCEPT FEATURE 15 
BATCH XXXXXXXX 38 INTERVAL 20,23,41 


BATCH XXXXXXXX RECORD CONNT-NNNNN EXPLANATION 34 


BEGIN DATA INPUT 6 
BMA 39 
BUFNO VALUE 43 


CANCEL 39,14,23 
CARD READER 9, 30 
CDL ?2,19,39 
CLASID 15,27,43 
CLASS 18,27, 39,15 
CLOSE 24-25,40-42,17,39 
COMPATIBILITY MODE 7 
CONDITIONS 

OVERLOAD 21,30,40 
CORE R&SIDENT 28 
CRDR %33-34,11,21 


_ CSPE 13-14 

CSMT 5,18 

CSMT CLOSE 24-25 

CSMT CNTRL 26 

CSMT CUSH 21 

CSMT CWTR STATUS RECEIVE 22 

CSMT DATBAS 25 

CSMT DUMP 24 

CSMT INQURY 21-23 

CSMT LINE 28 

CSMT NEGP 22-23 

CSMT OPEN 24-25 

CSMT OUTSRV 27 

CSMNT PGRM 26 

CSMT RNAWAY 21 

CSMT STALL 23 

CSMT TERMNL 27-28,18 

CSMT TIME 20 

CSMT TRACE 25 

CSMT TRMNAT 26 

CSOT TERMNL 13 

CSSF GOODNIGHT 6,3 

CSSL 9 

CSSWN PS 8 

CSST LINE 16 

CSST TERMNL 16 

CURSOR 6-7,31 

CUSHION 21,19,39-40 

CUSHION SIZE 21,39 

CWTR 35,38,12,21,40 
PARTICULAR REQUEST OF 35-36 
USE OF A 10 

CWTR EXIT ROUTINE 36 

CWTR TASK 38 


-D- 


DATA BASE 40-481,20,1 

CATA COLLECTION ENTRY 1 

DATA ENTRY 17-19,13,39 

DATABASE 24-25 

DATBAS 25,20,40 

DBFILE OPEN 25 

DELETE 11-13 

DELIM 11-12,33 

DELIMITER 12,11 

DESTID 23-24,43 

DPHATP 38 

DFHDMPA 24 

DISC 6 

DISCONNECT 37,8 

DISPATCH LIMIT 39 
CONSECUTIVE 22 

DISPLAY 15,19,40 

DISPLAY CONTROL UNIT 
REMOTE 2848 17 

DISPLY 27 

DUMP 24-25,40 


-L- 


LEASED LINES 


6 


LIMIT TASKS 40 
LINE 31-32,22,6,40-41, 15-17,20,4,7-9 


25, 28,6 


SERVICE STATUS OF A 40-41,4,28 


STATUS OF A 
LINE SYMBOL 


28,17 


NEW 6 
LIST 18,27-28, 16,40 
L60A 18 
-M- 


MASTER TERMINAL 
MASTER TERMINAL 
MASTER TERMINAL 
MASTER TERMINAL 
MASTER TERMINAL 
USE OF THE 
MAXIMUM TASKS 


6, 38-39,4-5,17,20 
KEYWORDS 39 
OPERATIONS 17 
OPERATOR 3,17,48,17 
FROGRAM 17-21 
18-19 
21,39 


MAXIMUM TASKS RECEIVE 21 


MAXT RECEIVE 
MODIFY TERMINAL 


NL KEY 6 


21 


STATUS 13 


OFF 23,40,42,8,17,25 


OPEN 24-25,40- 


42,17 


OUTPUT 35-36,10,38,12-13,2¢ 
AUTOMATIC 31 
OUTSRV 16,27,41 


PASSWD 13,171-12 
PASSWORD 29,11-12,9, 11, 13,22,35 


POLL DELAY 17, 


22,40 


NEGATIVE 22-23 


POOL 17 


RUNAWAY 20,41, 
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SECURITY KEY 8-9,30 


SERVICE STATUS 


4,17 


SHUTDOWN 27,19,41 


SIGN OFF 9,8 


SIGN-ON PROCEDURE 8 


SIGN-ON TABLE 


29,5,8 


SINGLE 18,27,13,41,3-4 


SMI CHARACTER 

STALL 4 
VALUE OF THE 

STALL INTERVAL 


6-7 


23,41 
23 


START SYMBOL 31,6 


STATUS 25,27,17-18,13, 12,35, 15,4,40-81, 3 


39 

STATUS OF TRACE 

CURRERT 23 
STOP 34,23,%2 
STORAGE CUSHION 21,39 
STORAGE CUSHION SIZE 21,17 
SUPFIX 33 
SOPERVISORY TERHINAL 15,13 
SUSPEND 15,41,27 
SWITCHED LINES 7,31~32 


Pa 


TASKS 
LISIT OF THE NUMBER OF 21 
RUNBER OF 39-40 
STATUS OF BATCHED 22 
TASKS VALUB 
MAXIMUM NOMBER OF 17 
TCAN TERMINAL POOL 17 
TCAK TBANINALS 26 
TERMID 26-28,22-23, 16, 12,18,40,43 
TERMINAL TEST FUBCTION 13 
TERMIVAL UNDER 1,15 
TERMINATE 15,17,20,41-02,26, 10,14, 39 
TERMINATE CICS 17,27,41 
TERMINATE CRDR 34 
TERANL 27, 18-19,42 
TIME 60~-42,21,3-4,7,18,20, 29 
TIAE INTERVAL VALUB 20 
TLT 16 ,43,39 
TRACE &2 
TRACE FACILITY 23 
TRACE TABLE 23,42 


TRANSACTION  29-31,4,7, 11-12, 1551,5,8,10 


6, 8-9,22, 39, a2 
BATCHED 33,11 | 
NOW-BATCHED 29 
3270-BASED 6-7 
TRANSCRIVE 4,9,13,42 
TRANSDATA 24-25 
TRANSIENT DATA 4&2 
TRANSAIT §,11-12,17 
THIGER  23,19,41 
TRIGGER LEVEL 23,42 
TRANAT 16,27,41 
TRECY 28,42 
TRACY RECEIVE 13 
FTROACATED GUTPUT 38 


~~ 


UPDATE 40,92,1,25 
USER-DBFIBED SIGH 9 


we Hf om 
WERIPY 34-36,29, 25 
~NOUMERIC- 


2260 COMPATIBILITY 6-7 

2260 COMPATIBILITY TRANSACTIOR 6 

2260 TAB PRATURE 6 

2741 TERRIBAL PROCEDURE 6 

2930 GEHERAL BANKING TERMINAL 

2995 GENERAL BANKING TERMINAL PROCEDURE 
3270 LSPORMATION DISPLAY SYSTER 6 
3270 PRINTERS 13 

3270 SCRERW 6 

3735 PROGRAMBABLE SUFFERED TERMINAL 8 
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SH20-1044-4 


Your views about this pubiication may help improve its usefulness, this form 
will be sent to the author’s department for appropriate action. Using this 

form to request system assistance or additional publications will delay response, 
however. For more direct handling of such request, please contact your 

IBM representative or the IBM Branch Office serving your locality. 
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Thank you for your cooperation. No postage stamp necessary if mailed in the U.S.A. (Elsewhere, an IBM office 
Or representative will be happy to forward your comments.) 
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This manual is part 0! a library that serves as a reference source for systems analysts, 
programmers, and operators of IBM systems.’ Your comments on the other side of this 
form will be carefully reviewed by the persons responsible for writing and publishing 
this material. All comments and suggestions become the property of IBM. 
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